MPImage
7.5 � 1996 Mark John Paddock[ < ] | [ > ] | [Contents] | [Index] | [ ? ] |
MPImage
7.5 Contents@Remark $VER: MPImage_guide 7.5 (14.3.97)
1 Quick overview | ||
2 Installation Instructions | Installation instructions | |
3 Software and Hardware required | ||
4 Shell and GUI parameters | ||
5 Known (and unknown) errors | ||
6 Version History | ||
7 Copyright and distribution requirements | ||
Index | The index for this guide |
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
MPImage
is a tool for viewing, scaling and converting Images.
It can load the following formats:
ILBM : All standard ILBM formats including EHB, HAM6, HAM8 and 24bit; PBM : All formats (P1, P2, P3, P4, P5 and P6); DataTypes: Any datatype supported format; JPEG : Loads JPEGs with Djpeg; PNG : Loads PNGs with pngtopnm. DCTV : DCTV ILBMs with dctv.library version 3.
It can view in the following modes:
Workbench : View in a window on the Workbench; Public Screen: View in a window on a named Public Screen; EGS Screen : View in a window on the default EGS screen. Screen : View on a custom screen
It can save in the following formats:
Greyscale: ILBM 16 shades and 256 shades; HAM6 : ILBM HAM6 with fixed, computed or supplied palette; HAM8 : ILBM HAM8 with fixed, computed or supplied palette; EHB : ILBM EHB with computed or supplied palette; COLOUR : ILBM with computed or supplied palette, 2 to 256 colours; ILBM24 : 24 bit ILBM; PPM : P5 and P6 modes. JPEG : JPEG with Cjpeg. PNG : PNG with pnmtopng. DCTV : DCTV ILBMs with dctv.library version 3
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The following files are included in this distribution and require installing in one directory:
You will also need to copy MPGui.library from libs/ and MPImage.library.??? to MPImage.library. Use .000 for 68000, .020 for 68020+, .881 for 68020+ and 68881+, .040 for 68040+, .060 for 68060.
The Install-MPImage script will do this for you. It will also let you set env: variables to enable JPEGs and PNGs to be loaded and saved.
MPImage : IconX script for ConvertMPImage with Gui interface. MPImage.guide : This file. ConvertMPImage : Shell command to convert/scale/view images. RunMPGui : Shell command to display a parameter requester libs/MPImage.library.#?: Image conversion library. libs/MPGui.library : Gui library. Install-MPImage : Installer script. gui/MPImage.gui : Gui definition file for MPImage. si/#? : Source code to ConvertMPImage. include/#? : Include files for MPImage.library. docs/#? : Autodocs for MPImage.library.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
OS3.0+ is required.
egs.library is required to display on EGS screens.
dctv.library is required to load and save DCTV images.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The following parameters can be supplied:
FROM parameter | Input file | |
X parameter | X size to scale to | |
Y parameter | Y size to scale to | |
MINX parameter | Minimum X to scale | |
MINY parameter | Minimum Y to scale | |
MAXX parameter | Maximum X to scale | |
MAXY parameter | Maximum Y to scale | |
PUBSCREEN parameter | Public screen to display image | |
EGS parameter | Display on EGS screen | |
NOREMAP parameter | Do not remap the image to the screen | |
CLONE parameter | Clone the bit map before displaying | |
TO parameter | Output file name | |
FORMAT parameter | Output format | |
FORCEGREY parameter | Force input to GreyScale | |
PALETTE parameter | Palette to use for output | |
COLOURS parameter | Number of colours to output | |
12BIT paramter | Use 12 bit colours | |
LINEAR paramter | Linear Grey mapping | |
WHITE0 paramter | Colour 0 White | |
MODENAME parameter | Screen Mode of output file | |
NOPROGRESS parameter | Prevent progress requester | |
GUI parameter | Display errors on Workbench |
MPImage
displays a Gui with a View/Convert gadget to
select the running mode and a Size gadget to select the sizing mode.
It also displays Ok
(keyboard shortcut O
), Cancel
(keyboard
shortcut C
) and Help (keyboard shortcut Help
).
The Esc
key can also be used to cancel the requester. Help
can also be
used over/in any of the gadgets to display context sensitive help.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This parameter specifies the name of the input file. See Overview for a list of the image formats that can be loaded.
F
can be used to activate the string gadget. With Right Shift
a file
requester is displayed.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
If this parameter is specified then the X size of the image is scaled to the number supplied.
X
can be used to toggle the selection of the parameter and activate the number
gadget. With Left Shift
the number gadget is activated.
If viewing on the Workbench or a Public screen then simple scaling is used. If saving or viewing using EGS then more clever scaling is used.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
If this parameter is specified then the Y size of the image is scaled to the number supplied.
Y
can be used to toggle the selection of the parameter and activate the number
gadget. With Left Shift
the number gadget is activated.
If viewing on the Workbench or a Public screen then simple scaling is used. If saving or viewing using EGS then more clever scaling is used.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This parameter (with the MAXX parameter overrides the X parameter. If the input image is narrower than then specified size then it is scaled to this width.
W
can be used to toggle the selection of the parameter and activate the number
gadget. With Left Shift
the number gadget is activated.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This parameter (with the MAXY parameter overrides the Y parameter. If the input image is shorter than then specified size then it is scaled to this height.
H
can be used to toggle the selection of the parameter and activate the number
gadget. With Left Shift
the number gadget is activated.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This parameter (with the MINX parameter overrides the X parameter. If the input image is wider than then specified size then it is scaled to this width.
I
can be used to toggle the selection of the parameter and activate the number
gadget. With Left Shift
the number gadget is activated.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This parameter (with the MINY parameter overrides the Y parameter. If the input image is taller than then specified size then it is scaled to this height.
E
can be used to toggle the selection of the parameter and activate the number
gadget. With Left Shift
the number gadget is activated.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This specifies the name of a Public screen on which to open a window and display the image.
P
can be used to activate the string gadget.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Specifiying this parameter displays the image on the default EGS screen.
This parameter is automatically specified if the View/Convert gadget is set to EGS.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Specifying this parameter prevents the image being remapped to the screen palette it is to be displayed on.
R
can be used to toggle this gadget.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Specifying this parameter can reduce the amount of chip memory used when loading Datatype images.
L
can be used to toggle this gadget.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This parameter specifies the name of the output file the image will be saved to.
If FORMAT is supplied TO is not supplied or supplied as "" then
the image is displayed on a screen. Note FORMAT=PPM
is not valid for this option.
T
can be used to activate the string gadget. With Right Shift
a file
requester is displayed.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This parameter specifies the output format.
The following formats are available:
BW16 : 16 colour grey scale ILBM BW256 : 256 colour grey scale ILBM HAM6 : HAM6 ILBM with fixed (internal) palette HAM6P : HAM6 ILBM with computed or supplied palette HAM8 : HAM8 ILBM with fixed (internal) palette HAM8P : HAM8 ILBM with computed or supplied palette EHB : EHB ILBM with computed or supplied palette COLOUR : 2 to 256 colour ILBM with computed or supplied palette ILBM24 : 24 bit ILBM PPM : P5 (if grey input) or P6 PBM format JPEG : JPEG format (using cjpeg) PNG : PNG format (using pnmtopng) DCTV3 : 3 plane DCTV ILBM with dctv.library version 3 DCTV4 : 4 plane DCTV ILBM with dctv.library version 3
If the output format is not a 24 bit format then the image is dithered using the Floyd-Steinberg method.
S
can be used to cycle the list view. With Shift
the list view
cycles backwards.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
If the image is being saved or viewed on screen then this forces the input to grey scale. This can save memory and speed up processing when scaling and saving GreyScale images as only one chunky buffer has to be scaled.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
If FORMAT is set to HAM6P
, HAM8P
, EHB
or
COLOUR
then this paramter can be used to specify the palette to use
for the output file.
The file specified should be an ILBM file.
A
can be used to toggle the selection of the parameter and activate the string
gadget. With Left Shift
the string gadget is activated.
With Right Shift
a file requester is displayed.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
if FORMAT is set to COLOUR
then this gadget can be used to
specify the number of colours in the output image (from 2
to 256
). If not specified
(not possible from the Gui) then the default is the number of colours in
the PALETTE file or 16
if no palette is supplied.
U
can be used to increase the value. With Shift
the value is decreased.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
if FORMAT is set to COLOUR
then this gadget can be used to
specify that colour remapping should use a 12 bit palette. The default is to generate
an 18 bit palette.
You should specifying this parameter if you are viewing the image on a pre AGA machine as the image conversion is much quicker.
B
can be used to toggle this gadget.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
if FORMAT is set to BW16
or BW256
then this gadget can be used to
specify that Linear Greyscale mapping should be used.
This can be used if the images are otherwise produced to bright.
N
can be used to toggle this gadget.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
if FORMAT is set to BW16
or BW256
then this gadget can be used to
specify that Colour 0 should be white, rather than black.
This can be used to e.g. better display menus on a screen.
1
can be used to toggle this gadget.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
If the FORMAT parameter specifies an ILBM then this parameter can be used to specify the screen mode (CAMG chunk) of the output file.
If not specified then a reasonable one is generated.
M
can be used to activate the string gadget. With Right Shift
a screen
mode requester is displyed.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
If this is specified then no progress requester is shown.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
If this is specified then error messages are displayed on a Workbench requester rather than the console.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This gadget selects the action. It has the following values:
View Workbench : View on the Workbench View Public Screen: View on a named public screen View EGS : View on the default EGS screen Save/View Screen : Convert and save the image or view on a screen
V
can be used to cycle this gadget. With Shift
the gadget cycles
in reverse.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This gadget enables either the X and Y gadgets or the MINX, MINY, MAXX and MAXY gadgets.
This lets either the actual or minimum and maximum scaled image sizes to be specified.
Z
can be used to cycle this gadget. With Shift
the gadget cycles
in reverse.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
A Palette file requires a body which is also loaded and then discarded.
The MODENAME may lose the monitor part.
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
MPImage - Amiga Image Load/Conversion program Copyright (C) � 1996 Mark John Paddock This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. mark@topic.demon.co.uk mpaddock@cix.compulink.co.uk
MPImage
5.1 is copyright � 1996 Mark John Paddock.
I can be contacted at:
mark@topic.demon.co.uk
or mpaddock@cix.compulink.co.uk
.
It can be freely distributed.
The palette construction is from Dr Dobbs Journal
and is
Copyright (c) Truda Software by Anton Kruger.
215 Marengo Rd, #2, Oxford, IA 52322-9383
The chunky<->planar conversion is by Morten Eriksen (mortene@stud.unit.no
).
[ << ] | [ < ] | [ Up ] | [ > ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Jump to: | 1
B C D E F G H I L M N O P Q R S T V W X Y |
---|
Jump to: | 1
B C D E F G H I L M N O P Q R S T V W X Y |
---|
[Top] | [Contents] | [Index] | [ ? ] |
This document was generated on April 16, 2022 using texi2html 5.0.
The buttons in the navigation panels have the following meaning:
Button | Name | Go to | From 1.2.3 go to |
---|---|---|---|
[ << ] | FastBack | Beginning of this chapter or previous chapter | 1 |
[ < ] | Back | Previous section in reading order | 1.2.2 |
[ Up ] | Up | Up section | 1.2 |
[ > ] | Forward | Next section in reading order | 1.2.4 |
[ >> ] | FastForward | Next chapter | 2 |
[Top] | Top | Cover (top) of document | |
[Contents] | Contents | Table of contents | |
[Index] | Index | Index | |
[ ? ] | About | About (help) |
where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:
This document was generated on April 16, 2022 using texi2html 5.0.